home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / tcp / PutMail3.lha / PutMail.doc < prev    next >
Text File  |  1995-06-03  |  8KB  |  229 lines
  1.  
  2. PutMail - Version 1.22
  3.  
  4.  
  5. INTRODUCTION:
  6.  
  7. PutMail is a SMTP Client, it is used for sending mail from your
  8. local Amiga host to an Internet SMTP host.
  9.  
  10. PutMail was written with referance to the following mail RFC's.
  11. RFC-821, RFC-822, RFC-1081, RFC-1225.
  12.  
  13.  
  14. REQUIREMENTS:
  15.  
  16. PutMail requires WB 2.04 as a minimum (and will also utilise the
  17. file buffering of WB 3.0 where possible).
  18.  
  19. PutMail is for use with AmiTCP (it will not work with AS225), it
  20. was developed on version 4.0 of AmiTCP but I have linked the 
  21. program to the old version 3 Net.lib for AmiTCP 3.0 Beta users.
  22. A number of MLink users are also successfully using PutMail.
  23.  
  24.  
  25. BACKGROUND:
  26.  
  27. When I signed up to get Internet access I keenly downloaded software
  28. from my local BBS and was immediately disapointed while reading the
  29. installation instructions.  It was quite clear that much of the
  30. software was ported from the Unix/UUCP environment as the software
  31. wanted a lot of assigns like UULib:, UUSpool: and many environmental
  32. variables.  Even worse, several software packages used the 
  33. environmental variables in conflicting mannors.  The Ported Unix
  34. code did not take full advantage to the Amiga OS and resulted in 
  35. large executable sizes.  I decided to write my own utilities.
  36.  
  37.  
  38. INSTALLATION:
  39.  
  40. I have provided both 68000 and 68020 executables for both AmiTCP
  41. version 4 and AmiTCP version 3.
  42.  
  43. Simply copy the PutMail executable (this is a dos command so no icon is
  44. required) to a location somewhere in your path.  A good place for it is
  45. in the AmiTCP:bin drawer.
  46.  
  47. I reccommend creating a file in your home directory named '.EMailAddr'
  48. (without the 's) which should hold your full E-Mail address (which is
  49. also used by GetMail).  See the details of REPLYTO below.
  50.  
  51. Next we need a SMTPHost definition which is the name of the SMTP Host
  52. that you use to send your EMail thru.  AmiTCP users should put an entry
  53. in their AmiTCP:db/hosts file, MLink users should create an
  54. environmental variable.  See the details of SMTPHOST below.
  55.  
  56. These items are not manditory but they do reduce the arguments that
  57. you need to pass to PutMail.
  58.  
  59. Provided AmiTCP is up and running you can use PutMail immediately.
  60.  
  61.  
  62. OVERVIEW:
  63.  
  64. E-Mail messages consist of a header and body.  The header contains
  65. details that are parsed by various processes, it contains the 
  66. destination E-Mail address, the sender, the subject etc.  The first
  67. blank line encountered indicates the end of the header and all else
  68. is assumed to be the body (and is not parsed).
  69.  
  70. PutMail creates a mail file on the T: drive from your header file,
  71. mail message and signature file.  It then connects to your SMTP host
  72. and transmits the full mail message.
  73.  
  74. PutMail uses three environmental variables that all exist in AmiTCP
  75. installations.  They are USER (userid), HOME (home drawer) and
  76. HOSTNAME (localhostname.domain).  Please note that AmiTCP creates
  77. these variables for you.  The login command creates the HOME variable
  78. (and the USER variable I think) so AmiTCP users do not have to set
  79. these variables up manually.
  80.  
  81.  
  82. USAGE:
  83.  
  84. The command template for PutMail is "PutMail MAIL=MAILFILE/A,
  85. TO=RECIPIENT/K/M,SUB=SUBJECT/K,HOME/K,REPLYTO/K,SMTPHOST/K,
  86. NOHEAD/S,NOADDR/S,NOSIG/S,VERBOSE/S" Phew!
  87.  
  88.  
  89. Lets go through the arguments one by one.
  90.  
  91. MAIL=MAILFILE  Manditory argument.
  92.  
  93. This is the name of your local mail message file that you want to
  94. transmit.  (Normally this will be the name of a tempory file
  95. from you E-Mail program.)  The argument can be specified as
  96. MAILFILE=foobar or abreviated as MAIL=foobar.
  97.  
  98.  
  99. RECIPIENT      Optional argument.
  100.  
  101. This is the E-Mail address of the person you wish to send the
  102. mail message to.  The argument can be specified as 
  103. RECIPIENT=user@domain or abreviated as TO=user@domain.
  104. You may send the same message to multiple addresses like so,
  105. TO=user1@domain user2@domain user3@domain.
  106.  
  107. If this argument is not supplied PutMail will obtain the "To:"
  108. E-Mail address from within your mail file.  PutMail also handles E-Mail
  109. addresses in this format "To: Martin Lanza <mlanza@southern.co.nz>".
  110. For multiple destinations simply put a comma at the end of each E-Mail
  111. address excluding the last one.
  112.  
  113. PutMail does handle multiline addresses provided that the RFC
  114. conventions are followed, ie the first character of the continuation
  115. line must be a space or tab.
  116.  
  117.  
  118. SUBJECT        Optional argument.
  119.  
  120. If you are using PutMail to include header/address information
  121. you can specify the message subject with this argument.  The
  122. argument can be specified as SUBJECT=foobar or abreviated as
  123. SUB=foobar.
  124.  
  125.  
  126. HOME           Optional argument.
  127.  
  128. This is the path to your home directory (not normally required).
  129. If you omit this argument the environmental varible HOME will be
  130. used to obtain the home directory.  This is really useful when
  131. you have multiple AmiTCP users, it means the program will use the
  132. correct header, signature and EMailAddr files in the message.
  133. It's only really required if you don't logoff an get the other
  134. user to logon.
  135.  
  136.  
  137. REPLYTO        Optional argument.
  138.  
  139. This is the correct E-Mail address that should be used to send E-Mail
  140. replies to you.  If you omit this argument PutMail will use the EMAILADDR
  141. environmental variable, if that does not exist it will read the 
  142. HOME:.EMailAddr file, if that does not exist your AmiTCP UserID & SMTP
  143. host name will be used to create the ReplyTo address (unless you don't
  144. want PutMail to create header/address details).
  145.  
  146. The contents of the HOME:.EMailAddr file can be in one of three formats.
  147.  
  148. 1) user@domain          eg: mlanza@southern.co.nz
  149. 2) user@domain (Name)   eg: mlanza@southern.co.nz (Martin V Lanza)
  150. 3) Name <user@domain>   eg: Martin V Lanza <mlanza@southern.co.nz>
  151.  
  152.  
  153. SMTPHOST       Optional argument.
  154.  
  155. This is the name of the SMTP host that you transmit out through (and
  156. should ideally be the host that holds your mailbox).  If this argument
  157. is not supplied PutMail will use the environmental variable SMTPHOST,
  158. if that doesn't exist it will look in your local AmiTCP:db/hosts file
  159. for the alias SMTPHost, if that doesn't exist it will use the name of
  160. the host that you are connected to (obtained from the domain part of
  161. the local host name in the environmental variable HOSTNAME).
  162.  
  163. Example of the hosts file entry.
  164. 192.231.84.33 mail.southern.co.nz SMTPHost
  165.  
  166.  
  167. NOHEAD         Optional argument.
  168.  
  169. PutMail will put your local heading on the top of all messages unless
  170. you specify not to with this switch.  The local heading comes from the
  171. '.header' file in your home directory which is obtained from the
  172. environmental variable 'HOME'.
  173.  
  174.  
  175. NOADDR         Optional argument.
  176.  
  177. This switch tells PutMail not to insert lines for "From:", "Date:",
  178. "To:", "ReplyTo:" and "Subject:" into the message header.
  179.  
  180.  
  181. NOSIG          Optional argument.
  182.  
  183. PutMail will put your local signature at the bottom of all messages unless
  184. you specify not to with this switch.  The local signature comes from the
  185. ".signature" file in your home directory which is obtained from the
  186. environmental variable 'HOME'.
  187.  
  188.  
  189. VERBOSE        Optional argument.
  190.  
  191. This argument simply switches on verbose reporting of the program's
  192. activities and progress.  If you have problems using PutMail this may
  193. help explain why it's not working.  You can always redirect the verbose
  194. output to a file and post this to be if you need assistance.
  195.  
  196.  
  197. DEVELOPMENT:
  198.  
  199. PutMail was developed on an Amiga 3000 running WB 3.1 using SAS/C 6.55.
  200.  
  201.  
  202. SO LONG AND THANKS FOR THE FISH:
  203.  
  204. I hope you find PutMail easy to use and usefull.
  205.  
  206. Bug reports, Comments, ideas, *POSTCARDS*, E-Mail, gifts and
  207. requests for new utilities all welcome.
  208.  
  209. -------------------------------------------------------------------------
  210.  
  211. This program is freeware, use and/or distribute as you wish
  212. on a "NON Profit" basis.  Inclusion on the Aminet and Fred Fish
  213. CD's is welcomed due to their long standing support of the Amiga.
  214.  
  215. No warranty exists, use this software at your own risk.
  216. I will answer all E-Mail and Snail-Mail messages.
  217. I can also be contacted on IRC #Amiga as mlanza.
  218. I do provide bug fixes via UUEncoded E-Mail.
  219.  
  220. Martin V Lanza
  221. PO Box 8344,
  222. Christchurch,
  223. New Zealand.
  224.  
  225. mlanza@southern.co.nz
  226.  
  227. Home Phone 64-3-366-1618
  228.  
  229.